home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / win_game / gin_rum.zip / READGIN.TXT < prev    next >
Text File  |  1996-04-09  |  19KB  |  445 lines
  1. Gin Rummy (Version 4.01) - READGIN.TXT
  2. ======================================
  3.  
  4. Introduction
  5. ------------
  6. Gin Rummy is probably the best known member of the Rummy family of
  7. card games.   
  8.  
  9. You play against the computer, which can be set to use a number of
  10. different skill levels.  At Champion and Master levels, the 
  11. computer is hard to beat and provides a very challenging game.
  12.  
  13. Customizable features include:
  14.     Colors
  15.         Sound effects
  16.         MIDI music
  17.         Speech synthesized messages
  18.     Card backs
  19.     Screen resolution and custom resizing
  20.         Card sizes
  21.     AutoMouse (moves mouse pointer automatically)
  22.     Opponent skill level
  23.         Rule variations
  24.  
  25. System Requirements
  26. ------------------- 
  27. To use Gin Rummy you need Microsoft Windows 3.1 and a mouse.
  28. Gin Rummy also has been tested with no problems under Windows '95.
  29.  
  30. An Intel 486 class system or better with 8 megabytes or more of 
  31. RAM is the optimum configuration.  An Intel 386 class system with
  32. 4 megabytes of RAM is considered to be the minimum.  Gin Rummy has 
  33. not been evaluated on less capable systems, but should present no 
  34. problems other than responsiveness and speed.
  35.  
  36. You are recommended to take advantage of the comprehensive help 
  37. file information in order to learn how to play Gin Rummy.  Perhaps 
  38. the best first step to learning Gin Rummy is to use the "Assistant
  39. | AutoPlay" option and watch the computer play against itself.  
  40.  
  41. Installation
  42. ------------
  43. The installation requirements are that all supplied files reside 
  44. in the same directory except that VBCTL3D.VBX should be placed in
  45. the windows\system directory.  Also, VBRUN300.DLL must be present
  46. in your path (typically in the windows\system directory).
  47. VBRUN300.DLL should be downloaded separately if you don't already
  48. have it on your system.
  49.  
  50. To use the sound effects and Speak-To-Me capability, you must 
  51. either have a sound card installed in your system, or have the 
  52. speak.exe driver installed to use your system's regular speaker.  
  53. Speak.exe is a freely distributed product from Microsoft, and is 
  54. available on most online services and bulletin board systems.  
  55. Gin Rummy is distributed with a few sound files, others may be 
  56. obtained from libraries on most online services and bulletin board 
  57. systems.  To enable sound effects, you must check "Enable" from 
  58. the "Sounds Effects" option under the "Configuration" menu.  
  59. Remember to "Save Configuration" to make the setting permanent.
  60.  
  61. Midi music files are not distributed with Gin Rummy for copyright 
  62. reasons.  You may acquire these from regular online sources.  You 
  63. will probably find canyon.mid in your Windows directory as this is 
  64. distributed with windows by Microsoft.  
  65.  
  66. Note that some systems are unable to handle midi music and other
  67. sounds at the same time. 
  68.  
  69. Registration
  70. ------------
  71.  
  72. Gin Rummy is shareware, and is fully functional.  You may evaluate
  73. this program for a period of 21 days after which you must register 
  74. it or remove it from your system.  To not comply with this 
  75. condition is a violation of United States and international 
  76. copyright law.
  77.  
  78. To register Gin Rummy, please use the printable order form under 
  79. the "Help" menu of Gin Rummy.  The cost of registration for the
  80. version you are currently evaluating is $15.  If you are unable to
  81. print the order form, please make sure that you:
  82.  
  83. 1. Specify that you are registering Gin Rummy 
  84. 2. Include sales tax if you are a Massachusetts resident
  85. 3. Enclose a check drawn on a U.S. bank, or an international money 
  86.    order, for the correct amount, in U.S. funds, payable to Carol
  87.    Bufton
  88.  
  89. We return checks made out incorrectly, or drawn on a non-U.S.
  90. bank.
  91.  
  92. You will receive your registration code by mail.  The registration
  93. code is encoded from your name, so be sure to provide your name 
  94. exactly as you wish to be registered.
  95.  
  96. If you require a diskette (3╜" only), add $5 making the total cost 
  97. $20.  The diskette version may contain a later version of Gin
  98. Rummy if improvements have been made since the release of your
  99. evaluation copy.  Because we cannot track which versions are
  100. currently available at what locations, it is possible that Gin
  101. Rummy will have been updated since your evaluation copy unless you
  102. downloaded a recent version from CompuServe or America Online.
  103.  
  104. Please allow 28 days for your registration to arrive, although 
  105. every effort will be made to mail your registration within 5 days.  
  106. Your registration code licenses you to use the version of Gin
  107. Rummy that you are currently evaluating, irrespective of which is 
  108. the latest version currently available on America Online, 
  109. CompuServe, or registered diskette.  Your registration may also be
  110. valid for future versions as they become available.
  111.  
  112. Note that Version 5 is not a free upgrade.  Existing registered 
  113. customers may upgrade and receive a new registration code for a 
  114. fee of $8.00.  See the "Upgrade" option under the "Help" menu.
  115.  
  116. You may not share your registration code with others.  Your 
  117. registration permits you and other users to use Gin Rummy on any 
  118. single-user computer system. You may also use Gin Rummy on any 
  119. other computer system of which you are the primary user, such as a
  120. laptop.
  121.  
  122. Distribution
  123. ------------
  124. You may distribute Gin Rummy to others provided that you derive no
  125. revenue other than that associated with the act of distribution, 
  126. and provided that you distribute the following, and only the 
  127. following, files intact and unaltered:
  128.  
  129.         READGIN.TXT  - This file
  130.     GINRUMMY.EXE - The program
  131.         GINRUMMY.HLP - The help file
  132.     RUMCRD1.WMF  - The small card images
  133.     RUMCRD2.WMF  - The regular card images
  134.         RUMCRD3.WMF  - The large card images
  135.         RUMCRD4.WMF  - The extra-large card images
  136.         VBCTL3D.VBX  - The Visual Basic 3D Effects extension
  137.         VBRUN300.DLL - The Visual Basic Runtime (if desired)
  138.  
  139. To the best of our knowledge, the wav sound files may also be 
  140. distributed freely.
  141.  
  142. Revision History
  143. ----------------
  144. Version 1.x  - Development versions.
  145.  
  146. Version 2.0  - Beta test version
  147.  
  148. Version 2.1  - First shareware release.  Fully functional.
  149.  
  150. Version 2.2  - Minor improvements and problem fixes.
  151.  
  152. Version 2.3  - Improved opponent skill algorithms
  153.  
  154. Version 3.0  - Custom card backs
  155.              - "Trim Corners"
  156.              - "AutoMouse - Dialogs"
  157.              - "Series Scoring"
  158.  
  159.         3.01 - Maintenance release
  160.  
  161.         3.02 - Maintenance release
  162.  
  163. Version 3.2  - "No Layoff On Gin" changed to "Layoff On Gin"
  164.              - "Display Deadwood"
  165.              - Expanded "Hint"
  166.              - Double-click discard
  167.              - "Check Meldable Discard"
  168.              - "Check Missed Layoff"
  169.              - "AutoSave"
  170.              - "AutoStart"
  171.  
  172. Version 3.3  - Trapping and ignoring a double-clicks
  173.              - Manual arrangement of cards in player's hand
  174.              - "No Sorting"
  175.              - "Ace Can Meld High"
  176.              - "Ellwood Gin"
  177.              - "No Bell"
  178.              - "Display Error Box"
  179.  
  180. Version 4.0:
  181.      Display - Enhanced 3D cosmetics for main display window, plus
  182.                cleaner overall appearance and expanded use of 
  183.                status bar.  
  184.              - Almost all texts now displayed "unbolded" to be
  185.                more consistent with the Windows '95 interface (and
  186.                to make more room on the status bar).
  187.              - Improved handling of "Large Fonts" display mode.
  188.              - 3D-Effects updated to improve cosmetics when 
  189.                running under Windows '95.
  190.              - Dialog background color can now be changed.  This
  191.                affects status bar displays, messages, and some 
  192.                information displays.  This has been introduced 
  193.                primarily to assist sight-impaired users who find
  194.                black on gray difficult to read.
  195.              - Default dealing method is now card-by-card to add 
  196.                realism.  A "Quick Deal" option is added to the 
  197.                "Configuration menu for users who prefer the 
  198.                previous "instant" display method.
  199.              - New style dialog boxes now include "Assist" button
  200.                when error messages are displayed in a dialog box.
  201.              - New "On-Screen" scoresheet displays all round 
  202.                scores for the current game, plus the running
  203.                totals for the current round and current game.
  204.              - New color configuration facility showing changes on
  205.                screen as they are previewed.
  206.              - Other on-screen counters moved to status bar.
  207.              - Scoremasts now display player name and opponent
  208.                skill.
  209.              - Gin Rummy main window is now dynamically resizable.
  210.              - Enhanced configuration options now support four 
  211.                screen resolution sizes (640x480 to 1280x1024) plus
  212.                custom resizing.
  213.              - Enhanced configuration options now support four
  214.                different card sizes (Small, Regular, Large, Extra
  215.                Large).  These can be set to change automatically
  216.                with changes to the window size.
  217.              - "Knock" display highlighting when Oklahoma rules
  218.                are in effect and points will be doubled.
  219.              - "Deadwood" display highlighting when deadwood
  220.                count is displayed and player is able to knock.
  221.  
  222.    Interface - Added support for single-button and non-standard
  223.                mouse properties by treating use of the ALT key 
  224.                with the left mouse button as being equivalent to
  225.                the right mouse button.
  226.              - Added "Drag and Drop" capabilities for moving cards
  227.                between the stock, discard area, player's hand, and
  228.                melds.
  229.              - Added ability for player to set aside cards as a 
  230.                separate group to the right of the player's main
  231.                hand.  This permits meldable cards to be grouped
  232.                separately from the main hand, for example.
  233.              - The top card of the stock is now displayed when the
  234.                mouse is clicked down and "taken" when the mouse 
  235.                button is released.  This permits the user to view
  236.                the card at their own pace.
  237.              - New status bar button to invoke Assist! (instead of
  238.                clicking on the status/error message).
  239.  
  240.    Assistant - Assistant menu now has "Recall" and "Deduce"
  241.                options to display information based upon which
  242.                cards have been seen by the player, and where.
  243.              - Assistant menu now has "Show Distribution" option
  244.                to display a map of all known (by the player) card
  245.                positions.
  246.  
  247.        Sound - Added support for playing MIDI music files with 
  248.                single, repeat, cycle and random play options.
  249.              - Added "shuffle" and "play card" sound effects.
  250.              - Added "Speak-To-Me" synthesized speech capability
  251.                (provided via PC Wholeware's WinSpeech program).
  252.  
  253.        Logic - Rewritten opponent logic for taking discards, 
  254.                knocking and discarding. Used by the opponent, 
  255.                AutoPlayer, and hint suggestions.  The new logic is
  256.                a little slower on the higher skill levels, but
  257.                should be more challenging.
  258.              - Improved Suggest (hint) facility which also allows
  259.                automatic execution of the suggested sequence.
  260.  
  261.        Rules - "Must Gin" option requiring that one only knock
  262.                when all ten cards can be laid down as melds.
  263.  
  264.   Miscellany - "AutoMouse" options moved to "Player" menu.
  265.              - Enhanced AutoPlayer information displays of points
  266.                in hand, etc.
  267.              - Various minor improvements.
  268.              - Some maintenance fixes.
  269.    
  270.        Price - The registration fee has increased to $15 ($20 with
  271.                diskette) and a new registration coding introduced.
  272.                Previous registration codes are not valid for this
  273.                version.  See the "Help" menu for an upgrade form.
  274.  
  275. Version 4.01 - Maintenance release 
  276.              - Fixed problem with misreported player deadwood 
  277.                count.
  278.              - Fixed problem with Ace not being able to be melded
  279.                high by the player.
  280.              - Fixed problem where Ace deadwood value was 
  281.                incorrectly calculated when Ace Can Be High is
  282.                selected.
  283.              - Fixed errors in help file (Rules Menu section)
  284.  
  285.  
  286. Frequently Asked Questions
  287. --------------------------
  288.  
  289. Q. In what programming language is Gin Rummy written?
  290.  
  291. A. Microsoft Visual Basic.  See the "For The Technically Curious"
  292.    section of the help file for more information.
  293.  
  294.  
  295. Q. Where did the name "MeggieSoft Games" come from?
  296.  
  297. A. See "Help | About" when running Gin Rummy.
  298.  
  299.  
  300. Q. Why do I get an "Invalid File Format" message when I try to run
  301.    Gin Rummy?
  302.  
  303. A. Because there is an older, and incompatible, version of 
  304.    VBCTL3D.VBX on your hard disk.  Gin Rummy is loading this 
  305.    rather than the version distributed with Gin Rummy.  Make sure
  306.    that the copy of VBCTL3D.VBX distributed with this version is
  307.    present in your \windows\system directory and make sure you
  308.    delete any older copies of VBCTL3D.VBX which are on your system
  309.    (possibly in the directory where you previously kept Gin Rummy,
  310.    or your \windows directory).
  311.  
  312.    [If you have multiple programs on your system which use 
  313.    VBCTL3D.VBX and they require different versions of VBCTL3D.VBX,
  314.    you can install a copy of the required version in the same
  315.    directory as each program that requires it.  Such a copy will
  316.    be loaded in favor of the "central" copy in the /windows/system
  317.    directory.]
  318.  
  319.  
  320. Q. Why does my mouse not work correctly in Gin Rummy?
  321.  
  322. A. We have had a couple of reported instances of this problem, but
  323.    we are unable to replicate it or guess at what the problem
  324.    might be.  One customer found that the problem disappeared when
  325.    he upgraded from Microsoft Windows 3.1 to Windows for 
  326.    Workgroups 3.11.  We therefore surmise that this problem is
  327.    system configuration dependent in some way.
  328.  
  329.  
  330. Q. What happens if Gin Rummy causes system messages, "bombs out", 
  331.    or freezes?
  332.  
  333. A. These problems are almost always to do with the way your system
  334.    memory is configured or managed.  Check that you have around
  335.    450K minimum of low memory available and that your memory
  336.    manager (e.g., EMM386) is not causing the conflict.  Gin Rummy
  337.    is quite intensive in its use of system resources and runs on
  338.    99% of customers' systems without problems. However, sometimes
  339.    such problems are reported, and all we can do is offer the
  340.    advice noted here.
  341.  
  342.  
  343. Q. Why do I get white rectangles displayed where the cards should
  344.    be (and other strange behavior)?
  345.  
  346. A. Very occasionally we receive reports of this problem, which is
  347.    a result of your graphics configuration not being able to load 
  348.    and/or display the card images.  If your graphics card is 
  349.    manifesting such problems, try setting the number of colors it
  350.    displays to 256, or even 16.  Alas, there is little we can do
  351.    about this situation without severly comprising Gin Rummy's 
  352.    display speed, since this is predicated upon holding relatively
  353.    large card image maps in memory.  However, you might find that
  354.    an updated driver is available for your graphics card if you
  355.    contact your system manufacturer.
  356.  
  357.  
  358. Q. Why do I get "subscript out of bounds" error messages and/or 
  359.    see Gin Rummy start to behave erratically?
  360.  
  361. A. Gin Rummy is designed to respond to single mouse-clicks, not
  362.    double-clicks.  In earlier versions it was possible to trip 
  363.    Gin Rummy if it reacted to the second click before it had 
  364.    finished processing the first click.  In versions 4.3 and 
  365.    later, Gin Rummy traps and ignores extra clicks when it is
  366.    busy.
  367.  
  368.  
  369. Q. I have my graphics display set to "Large Fonts".  Why are some
  370.    of the fonts displayed smaller?
  371.  
  372. A. Many graphics drivers (particularly for Windows 95) alter the
  373.    Twips parameter of the display in order to display everything
  374.    larger - not just the fonts.  Gin Rummy compensates for this by
  375.    shrinking some of the font sizes on those windows which display
  376.    card images, particularly the main playing window.  While this
  377.    makes everything fit the result is not as attractive as when
  378.    "Small Fonts" is the enabled graphics display mode.
  379.  
  380.  
  381. Q. How do I permanently change the default colors or card designs?
  382.  
  383. A. Set up the screen as you want the defaults to be.  Then select
  384.    the "Save Configuration" choice from the "Configuration" menu.
  385.    Consult the help file for more information.
  386.  
  387.  
  388. Q. Does Gin Rummy cheat by peeking at the player's cards?
  389.  
  390. A. No!  However, at the higher skill levels, Gin Rummy will
  391.    remember what you have picked up from the discard pile, and
  392.    will also make probability estimates of which unseen cards
  393.    might be in your hand versus the stock.
  394.  
  395.  
  396. Q. Why didn't you respond to the suggestions for enhancement I 
  397.    made?
  398.  
  399. A. Our first priority is to provide a quality game at the lowest 
  400.    possible price and this prevents us from entering into much
  401.    personal correspondence.  Most suggestions are incorporated 
  402.    into the next version of Gin Rummy. This is our way of
  403.    responding positively to your suggestions.
  404.  
  405.  
  406. Q. Why don't you accept credit cards or online registrations 
  407.    through CompuServe, for example?
  408.  
  409. A. Again, our first priority is to provide a quality game at the
  410.    lowest possible price and thus we keep our overheads to a 
  411.    minimum.  With respect to online registration, our customers
  412.    obtain Gin Rummy from a wide variety of sources and it would be
  413.    impractical for us to offer different registration means for
  414.    each source.
  415.  
  416.  
  417. Q. I am a shareware distributor.  How do I obtain permision to 
  418.    distribute Gin Rummy to my customers?
  419.  
  420. A. As noted earlier in this file, permission is automatically 
  421.    granted provided you distribute only the files noted herein.
  422.    Include VBRUN300.DLL if your customers might not otherwise have
  423.    it on their systems.
  424.  
  425.  
  426. Q. I am a software developer.  Are you able to share any of the 
  427.    Gin Rummy program code?
  428.  
  429. A. No.  All Gin Rummy code is proprietary to MeggieSoft Games,
  430.    except for the third-party components which are described in
  431.    the help file (in the section called "For The Technically
  432.    Curious").
  433.  
  434.  
  435. Q. Does MeggieSoft Games market any other games?
  436.  
  437. A. Rummy 500 was our first offering, released in August 1994 (see 
  438.    the help file for more details).  We released Gin Rummy, our
  439.    second product, in February 1995.  Pinochle is planned to be
  440.    our third game, and is tentatively scheduled for release in the
  441.    latter half of 1996.
  442.  
  443.  
  444. Gin Rummy  ⌐ MeggieSoft Games 1995, 1996.  All Rights Reserved.
  445.